úo┼£╚ÄΩD0P─≡9ä╤ 	l
┤·@
ùßHéß║╘Eâ═*Ç╘ *!x"╝%&Y'¬(∙)\	-£	.▄	/≡	0 	1
2*
3o
4á
5╦
6≡
78F9t:Ñ;∩<=c>º?⌡@=
Aq
B╗
CD4EkFóG╚HI=JeKyLîMΣN  °6;°yJ]pqzOLè¬δÇHâ█¬k+ªH:4║FKg╦4xHDÖ│C=3GτvAzG4R≡E╠F~Ü╝IE	GA	╞αS7D
&8TFFRl~U«G
tl,W¢D	tl╟XjGt|1\üB¬─▓^▀A
÷læ_*?+l╗`½G	`lfb8E
`─₧câF$t₧!j⌡@ +lq`BtΦvrKB"0┴x;Rl╞y«G¥▓t~\Kα≈╨éÑE
tluäOP?auô║G ù┤/ûäF	∞│ù█GAaÄÖ▓Açl@¢oOOtl»⌐íJtªP«?J╥ΘÅ»qN8;╗IJ oìI└ñA!┐▌φ┬3D"
	)	 ╞φJ"tl
╩_O"tll═&A
"tG	Æ╧ÅJ
#i	à	!╤yA
$½	└	Ü╙▀F%ly╘╓O"&O┘O'i▄╧D(
8▌╝N):
U
⌠▀LH*:
ë
@πNH+:
╖
Äµ▌H,:
┘
kΘH-:
²
l∞└	H3.:
0,÷
H/:
\6ⁿ H0:
îV■▓H⌐1╛╓H)2╛&gH 34Må,5HK4yÅ╗:½H5┐╒f@H6
$
ÇC"H#7┐V
óH«I 8î
Ñ
PN[H'9╤
Ω
½U|L:'Z'H;ON[╫Ow<ç%sy?=╢₧y┴O'>▀≤_Ç▌H?,<âûH@U╥å&H)A°ìH'BòUC»Uj ÑPress [PgDn] for information on using HELP!Using Help[PgDn File Manager]File Manager[PgUp Using Help][PgDn File Manager Help][PgUp File Manager Quick Help][PgDn File Manager Keys]File Manager Selection[PgUp File Manager]File Manager Delete[PgUp Miscellaneous Keys][PgDn File Manager Sort]File Manager Sort[PgUp File Manager Delete][PgDn File Manager Execute]File Manager Execute[PgUp File Manager Sort][PgDn File Manager Describe]File Manager Describe[PgUp File Manager Execute][PgDn File Manager Drives]File Manager Drives[PgUp File Manager Describe][PgDn File Manager Tree]Directory Manager[PgUp File Manager Drives][PgDn File Manager Edit]File Manager Edit[PgUp File Manager Tree][PgDn File Manager List]File Manager List[PgUp File Manager Edit][PgDn File Manager Copy]File Manager Copy[PgUp File Manager List][PgDn][PgUp][PgDn File Manager Mkdir]File Manager Mkdir[PgUp File Manager Copy][PgDn File Manager Archive]File Manager Archive[PgUp File Manager Mkdir]File Manager Test Archive[PgUp File Manager Archive]File Manager Virus Scan[PgUp File Manager Test Archive]File Manager Repack Archive[PgDn File Manager Select]File Manager AssociationsFile Manager Select[PgDn File Manager Exit]File Manager Exit[PgUp File Manager Select][PgDn Locate Files]Locate Files[PgUp File Manager Exit][PgDn Window Manager]Window Manager Quick Help[PgUp Locate Files][PgDn Window Resize/Move]Window Resize/Move[PgUp Window Manager][PgDn Archive Manager]Archive Manager Quick HelpArchive Manager Sort[PgUp Archive Manger Quick Help][PgDn Archive Manager Select]Archive Manager Select[PgUp Archive Manager Keys][PgDn Archive Manager Extract]Archive Manager Extract[PgUp Archive Manager Select][PgDn Archive Manager Delete]Archive Manager Delete[PgUp Archive Manager Extract][PgDn Packet Manager]Packet Manager[PgUp Archive Manager Delete][PgDn Packet ManagerPacket Manager Header[PgUp Packet Manager][PgDn Packet Manager Export]Packet Manager Export[PgUp Packet Manager Header][PgDn Packet Manager Delete]Packet Manager Delete[PgUp Packet Manager Export][PgDn Packet Manager Split]Packet Manager Split[PgUp Packet Manager Delete][PgDn Packed Message View]Packed Message View[PgUp Packet Manager Split[PgDn Packed Message Viewer][PgDn Message View]Message View[PgUp Packed Message View][PgDn Message Export]Message Export[PgUp Message_View][PgDn Path/File Selection]Path/File SelectionDirectory TreeIConfig ExitIConfig Menus[PgDn General]IConfig General[PgUp Configuration Menu][PgDn Archive Templates]IConfig Archive Templates[PgDn FidoNet Mailer]IConfig FidoNet Mailer[PgDn Paths Index]IConfig Paths[PgDn Key Definition]IConfig Keys[PgDn File Associations]IConfig File Association[PgDn Import/Export]IConfig Import/Export[PgDn General Options]IConfig General/Options[PgDn General Programs]IConfig General/Programs[PgUp General Options][PgDn General Swapping]IConfig General/Swapping[PgDn General Video]IConfig General/Video[PgUp General Swapping][PgDn General Mouse]IConfig General/Mouse[PgUp General Video][PgDn General Colours]IConfig General/Colours[PgUp General Mouse][PgDn General Colour Settings]IConfig General/Colors[PgUp General Colours][PgDn General FileList]IConfig General/FileList[PgDn FileList Templates]IConfig FileList Templates[PgUp General/FileList][PgDn General Lists]IConfig General/Lists[PgUp General FileList][PgDn Description Lists]IConfig Description Lists[PgUp General/Lists]IConfig Archiver Templates[PgDn Supported Archivers]IConfig Supported Archivers[PgUp Archiver Templates]IConfig Mailer/Type[PgDn Addresses]IConfig Mailer/Address[PgUp Mailer Type][PgDn Domains]IConfig Mailer/Domains[PgUp Addresses][PgDn Products]IConfig Mailer/Products[PgUp Domains]IConfig Paths EntryIConfig Keys EntryIConfig File Assoc Entry┘öÄ*	*UNREGISTERED Shareware Evaluation Version
╠eƒ
 ┌────┐
 │┌───┴┐                 
 ││┌───┴┐
 │││    │       InspectA Version 1.10
 └┤│ A │
  └┤    │      Copyright (C) 1992-1993
   └────┘
 
     David L Nugent & Unique Computing Pty Limited   
 
                         

 

This help system is arranged in a series of pages, with a topic index.
When invoking the HELP function by using F1, the help system is first
searched for information relating to your current operation and will
display it if found. From that point, you can navigate forward and 
backwards by page using the PgUp and PgDn keys on the cursor pad.

To search for a particular topic area, press F1 again for the help 
system index. This displays a complete list of help topics in which 
you can use the cursor keys to randomly access the help system database.

Press ENTER to view any displayed topic. Any single topic may occupy
several help pages, and selecting a help topic will go to the first page.

Help screens may exceed size of the window in which it is displayed. To 
read more of it, use the Up and Down keys to scroll the text.

The top or bottom of the display may include [PgUp] or [PgDn] prompts
which indicate either the continuation of the current topic on the
previous/next pages, or a change of topic and what its title is.

You may press ESC to exit the help screen at any time and return to the
previously active context.

╔═══════════════════════════════════════════════════ File Manager Quick Help ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════════╝

               »   / or toggle ALT key for pulldown menu   «

┌─── Function Keys ──────────────────────────────────────────────────────────┐

  F1 Help!              aF1 Change directory       ESC Exit, restore screen
  F2 Global [un]mark    aF2 Open new directory      aQ Exit, retain screen
  F3 List file          aF3 Display statistics   SPACE Toggle mark on file
  F4 Edit file          aF4 Rescan disk         cENTER [Un]zoom window
  F5 Copy file(s)       aF5 Toggle statistics   sENTER View OS screen
  F6 Move file(s)       aF6 Change video mode       cF Locate file(s)        
  F7 Create directory   aF7 Switch video mode       cS Scan file(s) for type 
  F8 Resort list        aF8 File list format        cD Change current drive  
  F9 Directory tree     aF9 Save window setup      INS Edit file description
 F10 Execute command   aF10 Execute previous       DEL Delete file(s)

                      »    mouse/window help    «

┌─ Marking ─────────────── Archives ────────────────── Windows ──────────────┐

   sUP Mark Up          aA Archive file(s)        sINS Open new window
 sDOWN Mark Down        aT Test archive(s)        sDEL Remove current window
 sPGUP Mark PgDn        aR Repack archive(s)       TAB Next window
 sPGDN Mark PgUp        aV Virus scan             sTAB Select window
 sHOME Mark to Start                             Grey* Resize/move window 
  sEND Mark to End                              sGrey* Iconise window     
 SPACE Toggle mark

┌─ Miscellaneous ────────────────────────────────────────────────────────────┐

 cPGUP Up directory     aI Paths index              ? Toggle menu titles
 cPGDN Down directory   aC Configure InspectA   ENTER Select/view/"action"
     \ Select directory aZ OS Shell                a- Memory statistics

  ╒═══════════════════════════════════════════════════════════════════════╕
  │NOTE: All keys may be redefined using ICONFIG, InspectA's configuration│
  │program. The chart above reflects InspectA's key assignments as shipped│
  ╘═══════════════════════════════════════════════════════════════════════╛

╔════════════════════════════════════════════════════════════════ Mouse Help ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚════════════════════════════════════════════════════════════════════════════╝

                                  Move window ─┐
 Click and release left             ┌────────┬─┴─────┐    ┌──── Iconise
 button on controls to                                 
 execute.                    ┌ ≡▒▒▒▒▒▒ Window Title ▒▒▒▒▒ ─ Zoom/unzoom
                       Close │  │                          │
 Click and release    Window ┘  │                          │
 right button to                │                          │
 exit or abort                  │     WINDOW  CONTROLS     │
                                │                          │
 Move window by clicking        │                          │
 left button on title bar       │                          │
 and drag window                └─────────────── Filename ╝ ─ Resize window
                                                   
 Resize by clicking on title     Sort direction ─┘  └─ Sort type
 bar and drag frame to size

 Clicking at any point on the top line invokes the pull-down menu system.


└────────────────────────────────────────────────────────────────────────────┘

This is InspectA's File Manager. Files in the current directory are
presented in a list and may easily be manipulated or viewed directly
from here. Multiple windows may show several directories at once, and
the TAB key or mouse can be used to quickly switch between directories.

    ╒════════════════════════════════════════════════════════════╕
    │ NOTE: Toggle ALT or press the / key to pull down the menus │
    ╘════════════════════════════════════════════════════════════╛

The pulldown menu system may be used to access most commands available
from the File Manager. Use the LEFT and RIGHT keys to select the 
previous or next menu, UP and DOWN to highlight the previous or next
menu item, ENTER to execute and ESC to abort and close the menu.

The "Special" menu item is used to present a list of user-defined
external commands (see IConfig, Keys).


┌─ Windows ───────────────────────────────────────────────────────────┐

For performance reasons, only the current window is updated and 
rescanned. If you need to update the display in an inactive window,
select it temporarily and then switch back.

Each window is handled as a logical "work area", and each has its own
sort criteria and direction, list format and current directory.

New windows are created by using sINS (Shift-INSERT), or you can pull 
down the "Window" menu and select the "Open" option. The only limit to
the number of windows you can open is the amount of memory you have
available.

You can resize the current window by pressing the Grey* key, found on
the numeric keypad (or on 83-key keyboards, it is the PrtScr key), or
by selecting the "Resize/move" option from the "Window" menu. Use the
cursor keys to move the window, hold down the Shift key to resize, and
press ENTER when you are happy with the results. You may also press ESC
to abort and retain the current window size and shape.

Unless it is the last window open, the active window may be closed by
pressing sDEL (Shift-DEL) or by clicking with the mouse on the Close 
Window button at the top left corner of the window.  To "put away" the
window and save its context while minimising the screen clutter, you
can 'iconise' it to the desktop by clicking with the mouse on the
Minimise button (the '' to the left of the top right corner of the
window), or by using Shift-Grey* or NumPad-5.


┌─ Files ─────────────────────────────────────────────────────────────┐

Information displayed in each window represents the contents of the
directory indicated by the window's title. The amount of information
and the format in which it is presented is dependant on which format
template is selected for the window. These templates are created and
maintained in IConfig (Alt-C, General, FileList).

Information which may be presented in this display include:

     ┌── MS-DOS & OS/2 ──┐       ┌─── OS/2 Only ────┐

      ■ File name                 ■ EA size
      ■ Size                      ■ Creation date *
      ■ Type                      ■ Creation time *
      ■ Attributes                ■ Last access date *
      ■ Last write date           ■ Last access time *
      ■ Last write time
      ■ Description

* These are not supported on FAT (DOS compatible) formatted partitions.

The file Type will show " ? " if it is yet to be determined, or is 
not known. To cause InspectA to examine all or marked files in the
current directory to determine their type, press Ctrl-S.

A file's Attributes are displayed as a series of characters; a dot
indicates that an attribute is NOT set, and one of the following
letters indicates that it is set:

   s  ···  System      r  ···  Read-only       S  ···  Shareable
   h  ···  Hidden      a  ···  Archive        [MS-DOS/Novell only]

Entries presented in any window may optionally be sorted by most of 
the above fields, either in ascending or descending order. Under OS/2,
case sensitive sorting may be used.

File descriptions may be displayed if there is a valid description file
in the current directory. The name of description files is determined 
by configuration (IConfig, General, Lists).

If your setup defines description files, you can maintain the
descriptions using the INS key (which modifies the existing comment
or creates a new one) or by editing the file containing the 
description file directly using the "edit" function.


┌─ Marking ───────────────────────────────────────────────────────────┐

Many commands and user-defined templates operate on marked files, if 
any, or the current file if not. The SPACE key may be used to mark the
current file. Alternatively, you can use the cursor keys (UP, DOWN, 
PGUP, PGDN, HOME and END) and mark while moving by holding down either
SHIFT key.

If the previous operation made use of file marks and caused files to 
become unmarked, file marks are restored by pressing F2. Otherwise
pressing this key toggles marks off (if all files were marked) or on 
for all files in the current directory.

File marks cannot be applied to subdirectory entries.


┌─ Directories ───────────────────────────────────────────────────────┐

While it is often desirable to open a new window to access another
directory, this need only be done if you wish to retain a quick access
path to the directory logged in the current window. However, it is
usually much easier to change the directory logged, either by selecting
an entry corresponding to a subdirectory or its parent, changing
directory directly by using the '\' key, or by using the drive
(Ctrl-D) or directory tree (F9) windows to select an alternative 
drive or directory.

Ctrl-PgUp changes to the directory above the current directory (if 
any) irrespective of which entry is currently highlighted. Ctrl-PgDn
changes down to the directory selected by the highlight bar.

To reread the current directory and refresh the display, press Ctrl-R.


└─────────────────────────────────────────────────────────────────────┘

Pressing enter selects the current file. The action taken is dependant
on the following:

 ■ Associations

   If an association (maintained by IConfig, Files) exists for the
   highlighted file, the external command template is executed.

 ■ File Type

   InspectA recognises certain types of files, such as compressed
   archives, FTSC type-2 packets and message files. Selecting this
   type of file causes InspectA to handle viewing of the file.

 ■ Viewer

   The default action taken when a file is selected where no 
   associations exist for the file and the file is not of a special
   type, then the file viewer is used.


┌─ File Manipulation ─────────────────────────────────────────────────┐

InspectA provides many internal file manipulation commands. This 
includes bulk copying, moving and deletion of files. Multiple files
are handled at the same time by marking the files and executing the
desired action via key or pulldown menu option.

When specifying a destination with the COPY (F5) or MOVE (F6)
commands, you may either enter a destination directory to move or
copy the files, or directory and file specification using wildcards
to rename the files during the copy or move operation.

When included in a destination file specification, the equals ('=')
character is treated specially - it is replaced with the ordinal
number of the file being copied; the first file being number 1,
second is number 2, and so on. This is only valid when a wildcard
character ('*' or '?') are used.

To locate files on any accessible drive or directory, use Ctrl-F.

To view the program screen, which contains the original MSDOS or OS/2
screen on startup and the output of any program run from InspectA,
press Ctrl-ENTER at any time.


┌─ Exiting ───────────────────────────────────────────────────────────┐

Pressing ESC exits InspectA and restores the program screen. Alt-X
exits in the same way, but bypasses the usual "Exit InspectA" prompt.

Pressing Alt-Q also exits InspectA, but retains InspectA's display.
Under MSDOS, it also changes to the directory logged in the current
window.


└─────────────────────────────────────────────────────────────────────┘

You are about to remove one or more files from the current directory.
Confirm that you wish to delete these file(s) by answering YES to 
delete, or NO (or simply press ESC) to abort.


This menu selects the sorting criteria for files in the current window.
Following is an explanation for each available sort option:

  ■ Unsorted

    Files are presented in the order as they appear on the disk. This
    usually indicates the physical ordering of files as they appear
    in the directory (but not guaranteed on networks of file systems
    which provide directory caching).

  ■ Filename

    Sorts by name of file - ASCII ordering.
 
  ■ Extension

    Sorts by extension (portion following the last embedded '.' in
    the file - this is often used to indicate the type of file).

  ■ fileSize

    Sorts in order of the file size. Under OS/2, extended attribute
    size is ignored.

  ■ Filetype

    Sorts by the type of file, where known. Where applicable, use
    Ctrl-S to scan the directory to determine file types first.

  ■ Description

    Sorts according to the description - ASCII ordering.

  ■ Lexical

    Lexical sorting is a variation on sorting by filename, except
    that files are first sorted by length of the filename and then
    by ASCII ordering within groups of the same length. This is
    useful when sorting files with numeric names into "numeric"
    order.

  ■ Write Date

    Sorts by the date/time last written.

  ■ Create Date       (OS/2 HPFS & compatible only)

    Sorts by the date/time of creation. File creation dates are not
    supported by all types of filesystems.

  ■ Access Date       (OS/2 HPFS & compatible only)

    Sorts by the date/time of last access. Access dates are not
    supported by all types of filesystems.

Directories are always sorted to the top of the list.

The OS/2 version also provides case sensitive sorting, if desired.
This is supported only on filesystems which support long names and
mixed case (such as HPFS and Novell NetWare volumes with OS/2 name
support installed). You must use the "default" file case and not
force upper- or lower- case (see IConfig, General, Options).

Filename is used as secondary sorting criteria if the primary sort
finds two entries equal.

└────────────────────────────────────────────────────────────────────┘

The execute prompt, accessed via F10 from the File Manager, provides
a convenient way of running external programs from InspectA. A history
of previously entered commands (up to 64) are retained and may be 
retrieved at any time using the UP, DOWN, PGUP and PGDN keys (for 
previous, next, first and last commands in the 'command stack')
or using F2 to pop up a list of commands and selecting the one you
wish to reuse.

Commands of two characters or less are not saved in the command stack.

Multiple commands to be executed consecutively may be entered on the
same command line by separating them with the caret character '^'.
If you wish to use this character on a command line, then preceed it
with a backslash.

Environment variables may also be used directly on this command line
by using the standard DOS & OS/2 syntax of surrounding the variable
name with the percent ('%') character. To use a percent character
in a command line without being interpreted as a lead-in or trailer
for an environment variable, then use two percent characters in
succession.


The describe function provides the ability to edit and save a 
description for any file or directory. Simply highlight the entry
you wish to edit and press INS - the existing description, if any,
is displayed for editing. This may be altered as desired or deleted
(using ^Y). Deleting the description for a file will also remove
reference to that file from the description file. Adding a 
description to any file in a directory which contains no 
description file will create one.

Like most of InspectA's prompts, there is a command stack available
which records up to 64 previous entries. Use UP or DOWN to scroll
through previous or next entries, or press F2 for a popup list of
the command stack.

Updates made to file descriptions are not written to disk immediately,
but are cached. The description file is updated only when the 
directory is rescanned (you can explicitly request this by using 
Ctrl-R from the File Manager, but it may also be done automatically 
after carrying out certain operations, such as editing files or 
running an external program), or whenever you move to a new directory
or window, or exit InspectA.


This is a list of all available drives on your system, both 'logical'
(SUBSTed, ASSIGNed and network) and 'physical'. The current directory
for all non-removable (not floppy) drives is also displayed against 
the drive letter.  Network and CD-ROM drives are indicated by the
asterisk character ('*') following the drive letter.

Select a drive from the list by using the cursor keys, or moving to 
the entry for a drive directory by pressing the letter corresponding
to the drive. Select by hitting ENTER. Abort (and retain the current
logged drive) using ESC.

Some device drivers and networks cause "phantom" drives to appear on 
this list; it will appear to the system as an invalid drive, but 
attempts to determine the current directory will fail. These drives
will display an error message where the current directory normally 
would appear. If one of these drives or a floppy drive without a 
diskette is selected, InspectA will simply refuse to change to it.


This is a graphical tree of the drive's directory structure which can
be navigated by using the cursor keys to step from one entry to the
next. The full path name of the currently highlighted directory is
displayed at the bottom of the screen.

Functions are provided to create, rename and remove directories:

  ■ Create Directory

    Add a directory below the currently highlighted level by pressing
    INS and entering a name.

  ■ Rename Directory

   Rename the currently highlighted directory by pressing F2 and 
   entering its new name. This operation may be disallowed on 
   certain types of networks, or where the directory is in used
   by another network workstation or process.

  ■ Remove Directory

   Delete a directory by highlighting it and pressing DEL. This
   will fail if the directory contains valid entries, such as files
   and/or sub-directories, if the directory is in use by another
   network workstation or task, or if the directory is the one
   currently logged by InspectA

Other functions available from the Directory manager include:

  ■ Rescan drive            Ctrl-R

    Forces the drive to be completely rescanned; updates the
    'diskmap', in memory and (if writing disk maps is enabled
    in IConfig) also on disk.

  InspectA will automatically update an existing diskmap for any
  any directories added, renamed or deleted with InspectA itself.
  Rescanning may be necessary if directories are added, changed
  or deleted by other software, or outside of InspectA.

  ■ Write map               Ctrl-W

    Forces the diskmap to be written to disk, whether disk-based
    directory maps are enabled or not.
    
  ■ Change to directory     SPACE

    Forces the current window to display (or refresh) the contents
    of the currently highlighted directory.

  ■ "Follow-me"             F10

    This enables 'follow-me' mode, where changing directory on the
    files list automatically updates the file window display. This
    can be fairly slow, especially on slower systems, very large
    directories or if accessing the filesystem across a network.
    Pressing F10 a second time disables this mode.

  ■ Change drive            F9  (Ctrl-D)

    Pops up the drives window to allow selection of a different
    drive.

└────────────────────────────────────────────────────────────────────┘

Press F4 to edit the currently highlighted file. The editor used is
determined by the setting in IConfig, General, Programs - if not
configured, the environment variable "EDITOR" is inspected and if
set is assumed to be the name of an editing program. If not set,
then InspectA invokes an editor called "Q".


Press F4 to view the currently highlighted file. The file viewer used
is determined by the setting in IConfig, General, Programs - if none
is ocnfigured, the environment variable "PAGER" is inspected and if
set is assumed to be the name of a file viewing program. If not set,
then InspectA invokes a program called "LIST".


Enter a destination path or file specification in the field provided,
or use the built-in facilities to select the destination path or file.
Use of wildcard substitution is supported.
                                                                
During the copy or move operation, any descriptions applicable
to the file will be moved or copied with the target file.

For more information, see File/Path Selection Prompt.


Moving or copying one or more MARKED files to a single target file 
(which already exists) is considered an error. If any files are 
marked on the files list the expected destination can only be a
directory, and if it does not exist, InspectA will prompt to see if
you wish to create it. Selecting YES to this prompt will create the
target directory "on-the-fly" and copy or move the selected files
into it.


To prevent accidentally overwriting existing files, InspectA will 
prompt whenever a destination file from a copy or move operation is
found to already exist. It will prompt to ensure that this is what
is intended.

If the target file is marked with the "read-only" attribute, InspectA
will prompt a second time, again to ensure that this is the intention.
Read-only files are considered "protected", but InspectA nevertheless
allows this to be overridden by confirmation.

In response, select:

  ■ Skip           To skip overwriting the target file
  ■ Overwrite      To confirm that this file is to be overwritten
  ■ Overwrite-All  To force all selected files to overwrite their
                   target. This prevents InspectA from prompting
                   again during the current copy/move operation
  ■ ESC            Aborts the copy/move operation



There are a variety of reasons why a copy or move operation might
fail:

  ■ Insufficient disk space on the target device (drive) in a
    copy operation or move from one device to another

  ■ Hardware related failure which triggered a critical error 
    during the move

  ■ Network directory or file permissions problem (not owner of
    the resource copied to, or insufficient privilege to open
    or read the original file

  ■ The original file no longer exists due to another process
    executed from another process or network workstation

  ■ The source or target file is in use by another network
    workstation or process.


Enter the name of a directory to create. If you are using
disk-based directory maps, the directory structure in the
disk image file will be automatically updated.

For more information, see File/Path Selection Prompt.


This prompt allows you to use one of the available compression
programs to archive one or more marked files. If you select an
existing archive to add to, its type will be automatically
determined and the correct archive program selected.

For more information, see File/Path Selection Prompt.


This option allows you to easily test one or more archives in a single
pass by marking or highlighting the file(s) you wish to test, and
pressing Alt-T. InspectA automatically scans known archive types and
uses the Test Archive template defined for the archive type. If the
test fails (as indicated by a non-zero exit code from the program run
during the test), the entry is marked with an asterisk next to the
file type.


This option allows you to scan a directory or one or more archives
for virus infection, using the configured virus scanner.

To scan all files in the current directory, ensure that no files are
higlighted and press Alt-V.

To virus scan specific archives, mark the archives to be scanned
and press Alt-V.


InspectA provides this option as a means of transferring the members
of one archive into another, optionally converting from one archive
type to another.

 ■ In order to convert FROM a specific archive type, there must
   exist an Extract-recursive archive template for that type.
   If the archive format does not support embedded paths, then
   copy an extract command to an extract-recursive command. If
   the format does support paths, then ensure that the switches
   which enable the extracting and creation of paths are given.

 ■ To convert TO a specific archive type, there must exist an
   Add-recursive archive command template for that type.
   Conversion to an archive type which does not support paths
   is not recommended, so you should avoid defining such a
   template for this type of archive to prevent attempts to
   repack into this format from occuring.

Virus-scanning of archives as they are repacked is also provided as
an option, and is highly recommended.

InspectA supports up to 8 levels of nested archives, but will only
repack archives within archives provided that they are of the same
type as the outer archive and provided that they have the same file
extension as the outer archive. This is intended to prevent repacking
of installation sensitive archives, where an install script of
program depends upon the specific format used to compress an
enclosed archive.

To repack inner archives into the same format as the outer one, first
convert the outer archive type to the same type as the inner 
archives, and then repack all archives to the desired archive type.

See also File Manager Archive on selecting an archiver.


This is a list of available archiver programs supported
by InspectA:

 ╒══════╤══════════════════════════╤═════════╤════════════╕
 │ Type │ Description              │ OS      │ Source     │
 ╞══════╪══════════════════════════╪═════════╪════════════╡
 │ AR5  │ ARC version 5.x          │ DOS/OS2 │ SEA        │
 │ PKA  │ PKARC/PKPAK              │ DOS     │ PKWARE     │
 │ PAK  │ PAK 2.5x                 │ DOS     │ NoGate     │
 │ AR6  │ ARC version 6.x          │ DOS/OS2 │ SEA        │
 │ AR7  │ ARC version 7            │ DOS/OS2 │ SEA        │
 │ ZIP  │ PKZIP 1.10               │ DOS/OS2 │ PKWARE     │
 │ ZI2  │ PKZIP 2.x                │ DOS     │ PKWARE     │
 │      │ Info-Zip 1.9+            │ DOS/OS2 │ InfoZip    │
 │ LZH  │ LHARC 1.x                │ DOS     │ Yoshi      │
 │      │ LH 1.x+                  │ OS2     │ A:WARE     │
 │ LHA  │ LHA 2.x                  │ DOS     │ Yoshi      │
 │      │ LH 2.x+                  │ OS2     │ A:WARE     │
 │ ZOO  │ ZOO 2.0                  │ DOS/OS2 │ Dhesi      │
 │ ZOH  │ ZOO 2.1+ high compression│ DOS/OS2 │ Dhesi      │
 │ ARJ  │ ARJ                      │ DOS     │ Jung       │
 │      │ UNARJ                    │ DOS/OS2 │ Jung       │
 │ HPK  │ HPACK 0.78+              │ DOS/OS2 │ Gutmann    │
 │ SQZ  │ SQZ 1.08.3               │ DOS     │ Hammarberg │
 │ DWC  │ DWC 5.01A                │ DOS     │ Cooper     │
 ╘══════╧══════════════════════════╧═════════╧════════════╛


A program capable of handling the specific archive type must be
present in order to manipulate archives using InspectA.


Whenever a file is selected by pressing ENTER in the File Manager
and that file matches one of the file associations specified in 
IConfig, Files - the specified external program is run, usually 
with the selected filename on the command line. This provides 
"hooks" so that custom editors and viewers can be invoked for 
particular types of files.


The default action on selecting a file from the files list is
to invoke either the specialised view mode if the file type is
known, or to use the external list program to view the file.

InspectA has several internal viewing facilities for known file
types; and file types are determined independant of the file
name:

 ■ MSG     If the file is a recognised "FTS-0001" format
           message InspectA will invoke message viewing mode
           and display the message contents, header and
           addressing details. Sometimes InspectA will fail
           to recognise *.MSG files which have been corrupted
           in some way or are not valid for some other reason,
           the most common of which is a corrupted or missing
           ASCII date in the header since a decypherable date
           is used as part of the "signature" of *.MSG files.

 ■ PKT     FidoNet FTS-0001 "type-2" packet files are detected
           and the specialised viewer provides a way of listing
           its contents, reading individual messages, providing
           diagnostic information in the case of corrupt packets,
           reading header and addressing information, with 
           editing and splitting functions useful for trouble-
           shooting.

 ■ Archive Several popular compressed archive formats are used
           and recognised by InspectA (see "File Manager
           Archive" for a complete list). InspectA is able to
           read and present a list of their contents, and
           allows extracting, viewing and deletion of of
           individual component files


The exit prompt ensures that you don't exit InspectA by
pressing ESC too many times to quit from other functions.
Enter "YES" (the default) to quit to DOS and restore the
original directory and program screen, or NO to abort and 
return to the File Manager.


This section provides the facility to locate files by name or partial 
name by searching a drive or partial drive (all directories below one
or more given directories).

At the "Locate" prompt, enter the filename - which may include the 
wildcard characters '? and '*'. If you wish to look for multiple
file types, separate the specifications with a semicolon - eg.

Search for files *.c and *.h, use "*.c;*.h" (with no quotes).

The prompt following requests the directory name(s) to search. Provide
one or more directory names separated by a semicolon. The directories
given and all subdirectories below are searched. If you wish to search
an entire drive, nominate its "root directory" (The drive letter 
followed by a colon and backslash).

As the filesystem is searched, files matching the file specification
are displayed. You can terminate the search at any time before the 
search is complete by pressing the ESC key.

Once the search is completed or has been terminated, the list of 
matching files is displayed.

After having been used once, the results of the previous list are
displayed. To search again using a different specifications or list
of directories, press Ctrl-F again.

╔═════════════════════════════════════════════ Window Manager Quick Help ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════╝

    Directories marked with the symbol  are iconised on the desktop.

┌─ Functions ────────────────────────────────────────────────────────────┐

    INS Add a new window after directory select
    DEL Remove a new window/directory
     F2 Iconise a window & move to bottom of list
  ENTER Select a new window/directory, even if iconised
    ESC Exit, retain current window

The Window Manager provides an easy access path to all of the windows
currently available, including Iconised (inactive) windows shown only
as a directory name at the bottom left of the desktop.

As an alternative to switching windows with the TAB key, the Window
Manager can be invoked and the desired window selected directly. Other
windows can be added, deleted or iconised easily by pressing a single
key.

└────────────────────────────────────────────────────────────────────────┘

Use this function (accessible via the Grey* key on the keyboard, or 
by using the mouse controls provided) to resize or move the current
window.

Use the UP, DOWN, LEFT and RIGHT keys to move the window frame to
the desired position. Hold down the shift key while using these keys
to resize the frame. Press ENTER to select the new size and position
or ESC to abort and retain the current window settings.

╔════════════════════════════════════════════════ Archive Manager Quick Help ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════════╝


┌─ Marking ─────────────── Utility ──────────────────────────────────────────┐

     sUP Mark Up            ENTER Associate or view
   sDOWN Mark Down             F3 View with Viewer
   sPGUP Mark PgDn             F4 Edit (rearchive if change)
   sPGDN Mark PgUp          F5/aE Extract members (aE)
   sHOME Mark to Start      F8/aS Sort members (aS)
    sEND Mark to End          F10 Execute (run) or associate
   SPACE Toggle mark          DEL Delete member file(s)
      F2 Mark/unmark all      ESC Exit to File Manager
                         

┌─ Supported archive formats ────────────────────────────────────────────────┐

The Archive Manager provides the ability to handle compressed archives made
by the following (and compatible) software:

 ╒═══════╤══════╤═══════════════════════════════════════════════╕
 │ Type  │ Vers │ Notes                                         │
 ╞═══════╪══════╪═══════════════════════════════════════════════╡
 │ ARC   │ 7.12 │ Full subdirectory support and 'Trimming'      │
 │ PKARC │ 3.61 │ ARC 5.x + 'Squishing' compression             │
 │ PAK   │ 2.51 │ ARC 5.x + 'Crushing' and 'Distilling'         │
 │ PKZIP │ 2.04 │ Includes support for 'Deflating'              │
 │ ZIP   │ 1.9  │ Info-Zip group                                │
 │ LHA   │ 2.13 │ Includes LHARC 1.x + LHA 2.x                  │
 │ ZOO   │ 2.10 │ LZW and high compression                      │
 │ ARJ   │ 2.30 │ All versions of ARJ up to 2.30                │
 │ HPACK │ 0.78 │ Support for 0.75 is NOT included              │
 │ SQZ   │ 1.08 │                                               │
 │ DWC   │ 5.01 │                                               │
 ╘═══════╧══════╧═══════════════════════════════════════════════╛

┌─ Member List ──────────────────────────────────────────────────────────────┐

When a known archive is selected for viewing, InspectA reads it and presents
a list of the archive's contents. This list includes:

 ■ File/Path       If the screen width is 80 columns or less, the 'root' 
                   filename is presented. If a directory name applies to
                   the entry, it will be followed by and asterisk (*).
                   If the screen width is > 80 colums, the full
                   path and file name is displayed.
                   In either case, the full pathname for the currently
                   highlighted entry is placed at the lower right border
                   of the frame around the listing.

 ■ Comp Size       Shows the size of the file as it exists within the archive
                   (ie. compressed size).

 ■ Orig Size       Shows the original uncompressed size of the member file.

 ■ Red%            Shows the percentage by which the file has been reduced.

 ■ Method          Indicates the type of compression used. This tends to be
                   specific to the archive type, and usually colloquial terms
                   for the compression method rather than having any 
                   technical significance. "Storage" universally means no
                   compression.

 ■ Date/Time       Original file's date/time stamp.

If an archive is found to be empty, this may indicate that it is corrupt.
If such an archive is encountered no managment functions are possible -
InspectA will simply prompt with a message.  Press any key to exit to the
File Manager.

└────────────────────────────────────────────────────────────────────────────┘

The Archive Manager initially presents the contents of an archive in
the order in which files are found in the archive. This list may be
sorted as desired:

  ■ Unsorted

    Original ordering (physical or directory order as found in the
    archive).

  ■ Pathname

    Sorts by full pathname, so that files in a common directory appear
    together, and sorted in paths by filename.

  ■ Filename

    Sorts by filename without regard to path.

  ■ Extension

    Sorts by file extension (then by filename).

  ■ fileSize

    Sorts by order of original (uncompressed) file size.

  ■ Date/time

    Sorts by order of date/time of the file according to the archive 
    directory.


Selecting a file from an archive list is almost the same as selecting
a file from the File Manager. Depending on the file type, InspectA 
will invoke one of its view functions; archives within archives are
viewed in archive mode, *.MSG and FTSC type-2 packets in message and
packet view modes, and general files with the external list utility.

File associations, if any, are applied.


This option allows individual or groups of (marked) files to be easily
extracted. Nominate or locate a path to extract to. If the directory 
to extract to does not exist, it will be created after confirmation.

Files are extracted one at a time, multiple at once (up to the maximum
command line length) or all at once by use of a response file,
depending on what the archive software supports and the command
template that is used.

See also Path/File Selection Prompt.


This option allows individual or groups of (marked) files to be
deleted from the archive. To ensure that accidental deletion of
files does not occur, InspectA prompts the user to make sure of
what is intended.

Files are deleted one at a time, multiple at once (up to the
maximum command line length) or all at once by use of a response
file depending on what the archive software supports.

See also Path/File Selection Prompt.

╔═════════════════════════════════════════════════ Packet Manager Quick Help ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════════╝


┌─ Marking ─────────────── Utility ──────────────────────────────────────────┐

     sUP Mark Up         ENTER/F3 View individual messages
   sDOWN Mark Down          F4/aC Toggle "changed" (force/prevent rebuild)
   sPGUP Mark PgDn          F5/aM Export message(s) to *.MSG format
   sPGDN Mark PgUp          F6/aW Export message(s) to text file
   sHOME Mark to Start      F7/cS Split packet
    sEND Mark to End        F8/aS Sort members (aS)
   SPACE Toggle mark           cA Toggle AREA/Subject display
      F2 Mark/unmark all       aH View packet header detail
                              DEL Delete individual messages
                              ESC Exit to File or Archive Manager

┌────────────────────────────────────────────────────────────────────────────┐

InspectA's ability to handle FidoNet type-2 packets is one of its most
powerful and unique features. This is useful only to operators of FidoNet
compatible mail systems which handle this type of file, which consists of
a packet "header" (or envelope) followed by zero or more individual 
messages.

To manipulate packets, InspectA first scans the contents of a mail packet
and creates an in-memory index. Handling of packets up to 5 megabytes in 
size presents no problem other than with processing speed, and for larger
packets than this, InspectA includes a unique interactive "split" function
to break apart packets into smaller packets.

InspectA begins examining a packet by reading its header and scanning 
individual messages as it creates its index, during which it displays a
progress indicator. This scanning process can be aborted at any time by
pressing ESC. However, if scanning of a packet is not run to completion,
no manipulation of its contents - except for "splitting" - are available.

Once the scan has finished or been terminated, a list of the packed
messages is displayed, showing:

┌─ Message List ─────────────────────────────────────────────────────────────┐

 ■ Inf       Diagnostic information - This relates to the state of each
             individual message, whether some detection or anomoly has 
             been discovered. If this field is blank, it indicates (probable)
             "perfect health". If not blank, one or more of the following
             messages may appear, with their meanings as follows:

      √  D   Malformed or invalid message date.
      √  L   One or more of the variable length header fields is longer than
             maximum.
      √  I   Invalid (non-ascii) data detected in header data.
      √  G   Message body contained one or more NULs.
             Malformed dates are (unfortunately) not uncommon. Other flags
             are usually an indication of more serious packet orruption.

 ■ Date      If the message date can be read, it is displayed here, or
             replaced by "*Invalid*" if not. InspectA is able to read and
             interpret many forms of non-standard date strings, even though
             they are flagged as such.

 ■ From      Shows the name of the author of the message.

 ■ To        Shows the name of the person to whom the message is addressed.

 ■ Subject   Shows the message subject.

 ■ Area Tag  If echomail area tags are enabled (see ^A) the area tag found
             in the message is displayed, else it is assumed to be netmail.

└────────────────────────────────────────────────────────────────────────────┘
┌─ Message Sort ────────────────────────────────────────────────────────┐

On selecting a packet, either from the file manager or from within a
compressed archive, the sort order will be according to the order of
occurrence. In sorting the order of messages in a packet, you only sort
their order of presentation, not how messages are physically sorted on
disk. To physically sort messages, you need to rebuild the packet in
the order in which the message is list currently sorted.

To sort or resort a packet, press F8 or Alt-S. Choose from the
following options:

 ■ Unsorted   Sort by order in which the messages occur in the packet
 ■ Area tag   Sorts alphabetically by area tag
 ■ msg Date   Sorts by date order, oldest first
 ■ msg siZe   Sorts by size of message, smallest first
 ■ To         Sorts alphabetically by the addressee name
 ■ From       Sorts alphabetically by the author name
 ■ Orig addr  Sorts by the originating net/node address
 ■ Dest addr  Sorts by the destination net/node address
 ■ Subject    Sorts alphabetically by message subject (excluding Re:)

└───────────────────────────────────────────────────────────────────────┘
┌─ Packet Changed ──────────────────────────────────────────────────────┐

Alt-C toggles the "changed" status on a packet. If the packet has been
marked changed (automatically enabled only by deleting one or more
messages), then you are presented with the option of writing those 
changes to disk when exiting.

┌─ Packet Header ───────────────────────────────────────────────────────────┐

From the packed message list, the Alt-H key provides a more detailed 
view of the packet header contents. Three separate windows provide
information about the packet header fields - use ENTER to cycle 
between them, and ESC to quit.

 ■ Packet Header  Displays details of the packet header, including the
                  source/destination of the packet and information about
                  the product by which it was made. (product information
                  is derived from the products list, which may be changed,
                  set or imported into IConfig.

 ■ Binary Dump    Shows the packet header block in "raw" binary format
                  for more detailed examination.

 ■ Diagnostic     Shows status against a series of status checks made
                  against the message overall, being:

         √ Pkt Status   Shows the overall status of the packet packet
                        itself. YES in this entry means that no serious
                        errors were detected.

         √ Invalid Hdr  Indicates that information in the packet header
                        appears to be seriously corrupted in some way
                        (it doubtful that you will ever see this, since
                        InspectA will normally not auto-recognise a file
                        as being a packet if this status is set, so
                        packet view mode would not be invoked in the
                        first place).

         √ Packet Date  Format of the packet date is incorrect.
                        This test is not applied to type 2.2 packets
                        which do not contain a packet date.

         √ Short Pkt    The packet is not terminated correctly. This can
                        indicate either that the packet has been 
                        truncated (the last message incomplete and 
                        perhaps additional messages missing) or there is
                        a problem with the software used to generate the
                        packet.

         √ Suspect Hdr  The header appears to be correct, but information
                        in one or more fields is out of range.

         √ Trash Data   One or more messages within the packet has been
                        found corrupt.

Note that some of these problems can be automatically corrected by InspectA
by forcing the "packet changed" on and rebuilding the packet. In the case 
of badly corrupted messages, the job may not be pefect, but it will usually
be enough to correct most packet header anomalies and almost all message
header problems. If messages are very garbled, it will probably be better
to export these to *.MSG format and remove them from the packet.

└───────────────────────────────────────────────────────────────────────────┘
┌─ Export Message ──────────────────────────────────────────────────────┐

The Alt-M key is used to export marked messages (or the current one is
none is marked) to FTS-0001 *.MSG format. Most FidoNet editors know how
to read this type of file, and it is by far the most commonly supported
format. Exporting to *.MSG format requires no interpretation or
translation of information contained within the packed message.

When exporting to this format, select a directory to export to. InspectA
will automatically determine the "next message number" from the existing
contents of the directory and will never cause an existing message to be
overwritten, even on a multi-tasking or network system (unfortunately,
some other programs are not so well behaved and may overwrite messages
that InspectA creates).

Note that unpacking in this fashion MAY cause zone and point information
to be lost from in-transit echomail messages. In 4D packet/addressing
schemes used by most 4D capable echomail processors, the packet header is
used to resolve the source and/or destination zone of individual messages.

Alt-W provides a similar option to export to plain text format. You
must provide a filename (not just a directory name) to which the message
contents are to be written.

└───────────────────────────────────────────────────────────────────────┘
Individual messages can be deleted from the message list using
the DEL key. This does not affect the physical packet on disk
until you confirm that you wish to rebuild it when exiting.

The confirmation prompt before deleting a message appears only
before deleting the first message from any packet - deletions
made after that are carried out silently.

Deleting one or more messages from a packet sets the "changed
packet" status. You can toggle this off using Alt-C and leave
the packet without rebuilding, thereby aborting any changes
that have been made.

If you prevented InspectA from completing the initial scan on
the entire packet deletions will not be allowed.
The packet split function provides the ability to break apart large
packets into smaller parts of equal size which can be handled more
easily, both by InspectA and other software. The only limitation on
the size of the source packet is available disk space.

You are prompted for a directory name to write the new packets to,
and the maximum number of messages per packet.
                                                                   
The resulting packets all have unique names, but inherit the same
header as the original packet as well as adopt the same last write
date and time. This is so that the packets will be tossed by an
echomail processor in the same order in which they would have been
had the packet not been split. The packet file names generated are
guaranteed to be assigned in ascending order.
Individual messages within packets can be examined and read by selecting
one from the packet manager with the ENTER key.

The message details are formatted and displayed, with the message header
details; author & addressee details, date written, origin and 
destination net/node and possibly an echomail area tag. Note that only
"raw" and uninterpreted header information is displayed, with no
interpretation whatsoever (as would normally be required for a message
editing interface, for example). The display is intended for debugging
purposes, so control lines are not read and applied to the address in
any way. Therefore all header addresses show net and node number only.

Beneath the dividing line, the message body is displayed. "Hidden" or
control information (any line in the message starting with ^a, SOH) can
be suppressed or displayed at the viewer's option, and by default are
switched on. Quotes within the message body may be highlighted,
according to the colour configuration in IConfig.
╔═════════════════════════════════════════════════════ Packet Message Viewer ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════════╝

┌─ Message Viewer Keys ─────────────────────────────────────────────────────┐

  F5/aW Write message to text format       LEFT Previous message in packet
  F6/aM Write message to *.MSG format     RIGHT Next message in packet
  SPACE Toggle mark on current message     HOME First message in packet
    ESC Exit to Message List                END Last message in packet
  F9/aL Exit to Message List    UP/DN/PGUP/PGDN Scroll message
     cK Toggle hidden lines         cPGUP/cPGDN Top/bottom of message
     cS Toggle SEEN-BY lines

    Note that InspectA provides no direct message editing capabilities.
  
The DEL key removes the current message only from the packet.
If the packet has not yet been modified, InspectA will first ask
for confirmation. If the entire packet had not yet been fully
scanned (ie. the usual scan on opening the packet had been
aborted), InspectA will deny any modification. If the message is
the last in the packet, control will return automatically to the
message list after the message is deleted.

Note that changes do not take immediate effect in the physical
packet until you elect to rebuild it when closing the packet.

Alt-W allows you to write a text image of the current message to a named
file or device. If the file exists, you can elect to either overwrite or
append the file.

Alt-M provides the ability to exports the current message to FTS-0001 
*.MSG format. Select a destination directory - message numbers are
allocated automatically from the next message number available in the
supplied directory.

This is the FidoNet FTS-0001 message view mode. The screen is
split into two sections: above the dividing line is the message
header information, which includes the original message date
and time, author and recipient, origin and destination node
addresses. Below the line is the message body, which includes
"hidden" control lines (these may be toggled on and off by
using ^K).

You can view more of the message by using the cursor keys - Up,
Down, PgUp, PgDn, cPgUp and cPgDn to display various parts of
the message if it extends beyond a single screen.

Press ESC to leave view mode and return to the File Manager.

From within Message View, Alt-W allows exporting of a message to
text format. Enter the destination device or file name - if the
nominated file exists you will be given the opportunity to overwrite
or append the file.

╔═══════════════════════════════════════════════════════ File/Path Selection ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════════╝


┌─ Path Select Keys ───────────────────── History ──────────────────────────┐

    F6 View named directory              UP Previous Entry
    F8 View index                      DOWN Next Entry
    F9 View directory tree             PGUP First Entry
                                       PGDN Last Entry
                                         F2 Popup history box


This prompt provides a prompt to select a destination file or directory.
Facilities are provided to:

 ■ Enter the destination path or file directly at the prompt, 

 ■ Use previous entries by scrolling through the prompt history,

 ■ Using a secondary file list to search for a file on disk,      [F6]

 ■ Using the Directory Tree to navigate quickly to a directory    [F9]
   or drive,                                                      [+F9] 

 ■ Selecting a directory from a preconfigured list of paths.      [F8]

These may be used in combination to locate any directory of file on 
your system.

╔════════════════════════════════════════════════════════════ Directory Tree ╗
║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
╚[ aKEY = Alt-KEY sKEY = Shift-KEY cKEY = Ctrl-KEY ]═════════════════════════╝

┌──── Selection ──────────────────────────── Editing ───────────────────────┐

   F9/cD Select new drive                      INS Add a new directory
     F10 Toggle "follow me" (from filelist)    DEL Remove current directory
         Switch to list from Path Selection     F2 Rename current directory   

  ■  Cursor keys navigate around the tree.
  ■  Mouse may be used to select a directory, or move the highlight
     using the scrollbar. Press right mouse button to exit.

See entry under Directory Manager for more information.


 ■ Select YES    to write changes to the configuration file to disk
 ■ Select NO     to exit and leave the original file unchanged 
 ■ Press  ESCAPE to cancel exit and return to IConfig's Main Menu

╔═══════════════════════════════════════════════════════ Configuration Menu ╗
╚═══════════════════════════════════════════════════════════════════════════╝

IConfig's menu system can be navigated in two directions:

 ■ Up/Down move the highlight bar up and down the vertical menu or list,
 ■ Left/Right move one option to the right.
 ■ The mouse may be used to select any visible option or entry by clicking
   once on the entry to move the highlight bar, and again to select the item.

To select any option from the main (horizontal) menu, hold down ALT key
and press the first letter of the option. Selecting a main menu option
automatically pulls down the associated menu or list.

╔═══════════════════════════════════════════════════════ General Menu ╗
╚═════════════════════════════════════════════════════════════════════╝

This is the General menu, which provides access to most of InspectA's
configuration variables. These affect InspectA's overall option, and
control, enable or disable its many features.

 ┌──────────┐
 │ Options  │▒  File Manager and general options and switches
 │ Programs │▒  External programs used directly by InspectA
 │ Swapping │▒  MS-DOS program image swapping options
 │ Video    │▒  Video and screen related items
 │ Mouse    │▒  Mouse options
 │ Colours  │▒  Colour configuration (colour & mono pallettes)
 │ FileList │▒  File Manager format template management
 │ Lists    │▒  Description file definitions
 └──────────┘▒
  ▒▒▒▒▒▒▒▒▒▒▒▒

╔══════════════════════════════════════════ Archive Command Templates ╗
╚═════════════════════════════════════════════════════════════════════╝

This is a list of archive command templates, which provides InspectA
with the ability to run external archiving commands to manipulate
compressed file archives. In order to extract, add to (or create),
or delete members from and repack particular types of archives, an
appropriate template must be defined for the archive type and
operation.

Press ENTER or F2 to edit an existing entry, INS to create a new
one, and DEL to remove the current entry.

To clone an existing entry and use it as the starting point of
another new entry (to save some work), use Shift-INS when the entry
you wish to clone is highlighted. You are placed directly into edit
mode in the new template form.

╔═══════════════════════════════════════ FidoNet Mailer Configuration ╗
╚═════════════════════════════════════════════════════════════════════╝

This is the Mailer menu, which provides access to configuration for
items for a FidoNet mailer. If you do not run a FidoNet mail system,
then items in this section can be ignored.

 ┌──────────┐
 │ Mailer   │▒  Defines the characteristics of the mailer in use
 │ Address  │▒  Defines ftn addresses applicable to this system
 │ Domains  │▒  Equates domain strings to avoid ambiguity
 │ Products │▒  Allows maintenance of the FTSC products list
 └──────────┘▒
  ▒▒▒▒▒▒▒▒▒▒▒▒

 ■ See also Paths Index for configuration of mailer-related
   directories.

╔════════════════════════════════════════════════════════ Paths Index ╗
╚═════════════════════════════════════════════════════════════════════╝

This section provides for maintenance of InspectA's path index, which
may be used to access often-used paths quickly. This is an optional,
but time-saving feature.

If you are using a FidoNet mailer, you will need to define one or more
directories in this section to make use of some of InspectA's mail
handling capabilities.

You should move the most often accessed directories to the top of the
list (holding down SHIFT and using the cursor direction keys will move
an entry). To add a new path, press INS; delete an existing path by
pressing DEL, and modify an existing entry by pressing F2 or
ENTER.

╔═════════════════════════════════════════════════════ Key Definition ╗
╚═════════════════════════════════════════════════════════════════════╝

This screen is used to define and maintain key bindings used by
InspectA's File Manager. This allows for both remapping of internal
functions and the provision for running external programs from the
keyboard using a command template, similar to those defined for
archiving programs. Command templates provide not only the ability
to run an external command, but to use parameter substitution from
the File Manager using the current or all marked files, running the
program once for every marked file, or passing multiple filenames
on the command line or in a 'response file'.

Entries which define a "Run external program" key are also presented
on the Special list on the pulldown menu system within InspectA.

Note that it is possible to bind a key to more than one function.
However, only the first one will be used when the key is pressed. This
is useful to allow for binding of many programs which are not activated
by a key but which are instead accessed from the pulldown list.

The number of definitions in this list is limited only by the amount
of memory available on your system.

The list presented displays the following fields from each entry:

 ■ Key           Displays the keycode for the entry. IConfig is able
                 to recognise all standard keys found on an enhanced
                 101-key keyboard and uses the symbol normally
                 associated with that key. If a key is shifted (that
                 is, one of ALT, CTRL or SHIFT keys are depressed
                 when the key is hit), a shift character is displayed
                 prior the key, where:

              ^  Indicates that the CTRL key is down
              @  Indicates that the ALT key is down
              #  Indicates that the SHIFT key is down

 ■ Description   This is a description associated with the key entry.

To define a new key, press INS. To remove an existing key, highlight
the entry and press DEL. To edit an entry, press ENTER or F2.

An existing entry may be cloned by using Shift-INS. This copies an
existing entry and forms a new one, and places you into edit mode on
the new entry. Modify as desired.

This list may be sorted alphabetically by key name by pressing Ctrl-S.
Individual entries may be reordered by holding down the SHIFT key and
using the cursor keys.

╔══════════════════════════════════════════════════ File Associations ╗
╚═════════════════════════════════════════════════════════════════════╝

This section allows you to modify what InspectA does when a file is
selected (by pressing ENTER) when in the file manager. By default,
InspectA will examine the file to see if it of a known type (archive,
packet, message file etc.) and if it is known invoke the appropriate
viewer. If not known, the defined LIST program is invoked.

A file association allows this action to be modified by first
matching this list of file specifications with the file selected.
If a match is found, the command template is used instead of the
normal action. External viewers, or any other program may be defined.

The list presented displays the following fields from each entry:

 ■ Filespec      Displays the file specification for this entry. This
                 is usually one or more wildcard characters, and
                 an extension, but may actually match any part of
                 a filename according to the operating system rules.

 ■ Description   This is a description associated with the entry.

To define a new key, press INS. To remove an existing key, highlight
the entry and press DEL. To edit an entry, press ENTER or F2.

Individual entries may be reordered by holding down the SHIFT key and
using the cursor keys. This may be necessary to change precedence of
entries; the first match found (examined in the order as presented in
the list) is the one executed.

╔══════════════════════════════════════════════════════ Import/Export ╗
╚═════════════════════════════════════════════════════════════════════╝

These options provide the ability to import and export configuration
data in text format.

 ■ Import     Reads a text file and parses it for configuration
              data

 ■ Export     Exports all configuration data to a named text file.

These options correspond with the command line options -i file
(import configuration from file) and -x file (export configuration
to file).

┌─────────────────────────────────────────────────────────────────────┐
└─ General Options ───────────────────────────────────────────────────┘

This screen maintains many items which configure the way in which
InspectA operates.

 ■ Kbd Delay       Sets the keyboard typomatic delay. This is the
                   time between a keypress and when the key starts
                   to repeat.

 ■ Kbd Speed       Sets the keyboard repeat rate.

   Setting either of these options to Auto tells InspectA not to
   modify the keyboard typomatic settings. InspectA will not attempt
   to restore or reset the settings on exit.

 ■ View Path       Names a directory to be used for viewing member
                   files within archives.

   This path need not exist before InspectA is used - it will be
   created and deleted as required (it will not be deleted if it
   does exist).  If left blank, InspectA will use a subdirectory
   of the directory in which the archiver resides. Using this field
   is mandatory if you wish to view files in archives on CDROM or
   any read-only file system.

 ■ Dir Index       Enables (Yes) or disables (No) writing of a 
                   directory index to disk.

   By default, InspectA does not write disk index files. These index
   files speed InspectA's operation by not requiring that the disk be
   physically scanned to determine the directory structure whenever
   the Directory Tree function is invoked. Even if this function is
   disabled (the default state), InspectA will still update and use
   disk index files if they exist, but it will not create them. The
   recommended setting is Yes (enabled).

 ■ Index File      Determines the name of the disk index file. If
                   none is specified, the default is diskmap.ind.

   The actual name of the index file used depends upon entry in the
   following fields. If a specific path is given, all (or only network
   drive) index files are placed in the same directory, with the first
   letter of the given filename replaced by the drive letter to ensure
   that they are unique.

   If you run both the OS/2 and MSDOS versions on the same machine or
   on a network drive with longname support, it is recommended that
   each operating system use a different base name for its index since
   directories may be visible from OS/2 but not from MSDOS, or may
   be displayed with a different name conforming to MSDOS file naming
   conventions.

 ■ Index Path      Specifies a path to use for storage of disk index
                   files.

   If this field is left blank, InspectA writes the disk index files
   onto the root directory of the drive being indexed. If a path is
   specified without a drive designation, the index file is created
   in the given directory (which is created automatically if it does
   not exist) on the target drive. If a drive and path are specified,
   all index files are placed in the given directory with the first 
   letter of the index file replaced by the letter of the drive.

 ■ Net Path Only   If enabled and an Index Path is specified, InspectA
                   stores the index files for network and CDROM drives
                   in the given path, but uses the root directory on
                   local drives.

   This is particularly suitable for networks where workstations have
   their own local drives. Placing index files for workstation on the
   network drives would cause some conflict, but indices for network
   drives (provided the drive assignments on each workstation are
   equivalent) may be shared.

 ■ Archiver        Specifies the type of archiver you prefer. This
                   is used to prompt for the archive format to use
                   when creating or repacking an archive.

   The Filedesc fields apply to description files (files used for
   storage of descriptions of other files in the same directory).

 ■ Filedesc Fill    Determines whitespace padding between a filename
                    and the start of the description text.

   The entry in this field is used as the column in which the
   description starts. An entry of 0 specifies no padding, and will
   force placement only of a single space character between the file
   name and description. If the length of a filename exceeds the 
   given column, then only one space will be used. The filename will
   not be truncated.

 ■ Filedesc Case    Provides an option to force the filename placed
                    into description files to upper or lower case.

   If left at the Default setting, InspectA will use the case as
   determined by the setting of Filename case. If that is also set
   to Default, case is then determined by the operating system;
   under MSDOS or OS/2 on a FAT drive this will be upper case, under
   OS/2 on a filesystem which supports HPFS long names, this will be
   the case as determined directly from the drive. Using mixed case
   under OS/2 provides the opportunity to sort files in a case 
   sensitive manner.

   The Filename fields apply to the appearance of files in File 
   Manager windows.

 ■ Filename Cols    Sets the default number of colums to allocate to
                    the filename in File Manager windows. If left
                    at zero, this defaults to 13 characters (the
                    maximum for FAT based systems and MSDOS).

   If the length of a filename exceeds the specified number of columns
   the name is truncated in the list, with the last character shown
   as a right arrow '', indicating that the filename is longer than
   can be displayed.

 ■ Filename Case    Provide the option to force the filename displayed
                    in File Manager windows to upper or lower case.

 ■ Desc Cols        Determines the maximum display width of file
                    descriptions in File Manager windows.

   If the length of a description exceeds the specified number of
   columns it is truncated in the list, with the last character shown
   as a right arrow '', indicating that the description is longer than
   can be displayed. The default description with is 255 characters.

 ■ Dirname Case     Provides an option to force the name of
                    directories displayed in the File Manager to
                    upper or lower case.

 ■ Hide Menus       This option allows the pulldown menu titles in
                    the File Manager to be hidden from view when 
                    the menus are inactive.

 ■ Title Justify    Determines how a directory title is placed on the
                    window frame - it can be left or right justified
                    or centred.

 ■ Title Fill       Provides the character to use for "filling" the
                    title bar on File Manager windows. It defaults to
                    the space character.

   This entry is an ASCII code from 0 through 255. Some examples:

         ┌───────────────────────────────────────────────┐
         │ ░ 176   ▒ 177   ▓ 178   █ 219   · 250   ■ 254 │
         └───────────────────────────────────────────────┘

 ■ No 'hot' Alt     Disables pulldown menus by pressing and releasing
                    ALT.

   InspectA usually invokes the pulldown menu system in response to 
   pressing and releasing the ALT key. When used under windowing 
   systems such as OS/2 WPS, MicroSoft Windows or DESQview, this may
   interfere with the normal operation of these keys.

 ■ Enable Stats     Enables the disk statistics window in the File
                    Manager to be active on startup.

   The File Manager statistics window provides information about the
   currently logged drive and directory, and more detailed information
   about the currently highlighted file. Because this information can
   cause a performance penality on slower systems or when using 
   network or very slow non-cached disk drives, this option defaults to
   off. The disk statistics box can be interactively switched on or
   off in the File Manager by using Alt-F5.

┌─────────────────────────────────────────────────────────────────────┐
└─ Programs ──────────────────────────────────────────────────────────┘

These options select the external programs used for file editing,
viewing and virus scan. You may provide a full path name for faster
loading, but it is not necessary if the program resides in your PATH.

  ■ Editor        Program name of your text editing software. This
                  program should be able to accept a filename on the
                  command line.                                 

  ■ Viewer        Name of the program to use for file viewing.

  ■ Scanner       Name of the program used for virus scanning. This
                  should also specify any command line switches
                  according to the program's documentation.

The following fields apply only to the MS-DOS version. These
control 'smart' program image swapping; the entry in these fields
specifies the amount of memory that a program uses, and may be:

      √ memK      Amount of memory actually required by the program.
                  If specified, and that amount is available without
                  requiring InspectA to swap itself out, the program
                  is run directly without swapping. If insufficient
                  memory is available to run the program and program
                  image swapping is enabled (see next help screen),
                  then InspectA will remove itself from memory before
                  running the program.
      √ -1        Forces InspectA to run the program without swapping
                  regardless of the amount of available memory.
      √ 0         Forces InspectA to run the program with swapping
                  (but only if swapping is enabled globally) regard-
                  less of the amount of available memory.
  
  ■ Edit mem      Amount of memory used by the editing program.

  ■ View mem      Amount of memory used by the file viewer.

  ■ Scan mem      Amount of memory used by the virus scanner.

┌─────────────────────────────────────────────────────────────────────┐
└─ Swapping ──────────────────────────────────────────────────────────┘

The MS-DOS version features the ability to swap itself out of MSDOS
conventional memory to provide external programs as much memory as
possible. When enabled, this feature is automatic, and can be made
optional on a per-program basis and dependant upon how much memory
the program requires and how much is free.

 ■ Swap Path         The path specified is used when swapping the
                     program image to disk. Note that even if you
                     use XMS or EMS swapping (see following option)
                     you should still specify a path here that both
                     exists and is writable. It is possible that
                     InspectA can fall back to swapping to disk if
                     there is insufficient XMS or EMX memory
                     available.                    

 ■ Swap Type         Determines the default method of swapping.
                     Options available are:

           None      Disables swapping globally
           XMS       Uses XMS memory, if available.
           EMS       Uses EMX memory, if available.
           Disk      Uses disk.

If your system is an 80286 AT or better and you have a driver loaded
which supports XMS memory (such as MicroSoft's HIMEM.SYS or any 80286
or 80386 memory manager) you should use this because it is in general
much faster that the other available methods (the swapping process
will barely be noticeable, if at all).                            

┌─────────────────────────────────────────────────────────────────────┐
└─ Video Options ─────────────────────────────────────────────────────┘

This section provides options which determines how InspectA uses the
video display.

 ■ Video Mode     This option selects the default size of the screen.

   The Auto option tells InspectA not to modify the video mode at
   startup, and allows it to automatically adjust to the current
   screen size and mode (this can be forced with the -v0 command line
   switch).  Other settings may be selected, depending what is 
   supported by your display adapter.

   The Custom option allows you to specify a video mode to use. This
   facility exists for SuperVGA and XVGA extended text modes (see next
   field).

 ■ Custom   [MSDOS] This field specifies the mode number that is
                    to be used when the Custom video mode option
                    is selected.
            [OS/2]  Enter the desired number of rows and columns.
                    If running InspectA in a window on the PM desktop
                    you must specify 80 columns and a number of
                    rows in the range 10 - 255. When run in a 
                    full-screen session and have an SVGA adaptor
                    which supports 132 columns, you may use either
                    132 or 80 columns, and a range of possible
                    rows settings, depending on the availability of
                    fonts.

 ■ Set Mode         This setting allows InspectA to permanently
                    set the video mode (or screen size) so that
                    the video mode is retained after InspectA 
                    terminates and is not reset to its previous mode
                    when running external programs.

 ■ Background       Colour video adaptors may be set to use intense
                    or blinking background colours. If Auto is
                    selected, InspectA does not modify the current
                    setting.

 ■ Dir Window       This option sets the default size of the Directory
                    Window accessed via F9 from the File Manager.
                    Set according to preference.

 ■ Screenblank      This field is the timeout (in minutes) between
                    InspectA becoming idle and when the screenblanker
                    is activated.

   Note that the idle time check for screenblanking only occurs on
   minute boundaries, and that a value of 1 in this field will cause
   the screen to blank as soon as the minute boundary has been crossed
   since the most recent keyboard/mouse activity. This may cause the
   screen to blank momentarily whenever any minute boundary is crossed
   even when typing, so the value specified should be greater than 1.
   A value of 0 in this field disables the screenblanking feature.
   
 ■ Scan Time        This field is the timeout (in minutes) between
                    InspectA becoming idle and when the current
                    directory is rescanned.

   This is useful on multitasking systems or networks, when the
   contents of a directory are likely to change from activity in 
   other processes or by other workstations. Like screenblank, a
   non-zero entry should be greather than 1.

 ■ Frame (A)        Selects the ACTIVE window frame type.

 ■ Frame (I)        Selects the INACTIVE window frame type.

   The File Manager deals with Active (the current) and Inactive 
   windows, and uses the frame type to visually indicate which is
   active. Select the desired type(s) from the selection box.

┌─────────────────────────────────────────────────────────────────────┐
└─ Mouse Configuration ───────────────────────────────────────────────┘

This screen provides options related to the mouse device.

 ■ Use Mouse        By default, the mouse is not active and must be
                    enabled by changing this setting to Yes.

 ■ Mouse Pointer    Select the type of mouse pointer:

         Standard   This is the default text mouse cursor provided 
                    by the mouse driver software.
         Diamond    An opaque diamond-shaped cursor, with a white
                    foreground that tends to stand out well.
         Triangle   A bright yellow pyramid that looks like a 
                    pointer.

 ■ Mouse Speed      Selects the desired mouse tracking speed; the 
                    ideal setting tends to vary according to 
                    preference. Settings from Slow through to
                    V.Fast are provided.

 ■ SVGA Mouse       Some MSDOS mouse drivers have problems when
                    operated in SuperVGA text modes (typically 132
                    column modes, but also some others). This switch
                    enables or disables the mouse when in these text
                    modes and should be set according to how the 
                    mouse driver you use copes with them, but it does
                    not override the Use Mouse setting.

┌─────────────────────────────────────────────────────────────────────┐
└─ Colour Configuration ──────────────────────────────────────────────┘

InspectA internally maintains two separate colour pallettes for use on
display adaptors which either support colour or not. The specific
pallette used on any system is determined automatically on startup.

The colour and monochrome pallettes can be maintained separately by
IConfig, and on selecting IConfig/General/Colours you are offered the
choice of which pallette to edit.

  Select:

       Colour           to edit the pallette used for colour capable
                        display configurations.

       Black&White      to edit the pallette used for monochrome or
                        two colour display configurations.

┌─────────────────────────────────────────────────────────────────────┐
└─ Colour Configuration ──────────────────────────────────────────────┘

This screen combines a colours list and an attribute selection box.
Below the colours list, an example screen is display showing a 
sample which includes the currently highlighted colour.

Each colour is assigned by function rather than to a specific screen
or display. This provides for consistent colour assignments throughout
InspectA's operation.

There are several classes of display objects that InspectA uses. There
are:

 ■ Screen/default
 ■ Form/data entry windows
 ■ Picklist windows
 ■ Menu windows
 ■ Error message boxes
 ■ Text view/edit boxes
 ■ Popup/pulldown windows

Each colour setting belongs to one of these classes. Typically, 
because related settings tend to be displayed as a group, they
are maintained and blended together to provide colouration that
is pleasing to the eye.

To change the attribute assigned to any colour setting, press ENTER
to enter attribute change mode. To modify the colour, move the cursor
keys around the attribute panel - this updates the example display
so that you can test to see what this might look like.

To select an attribute, press ENTER. To restore the former setting,
press ESC.

┌─────────────────────────────────────────────────────────────────────┐
└─ File List Templates ───────────────────────────────────────────────┘

This window displays a list of file list templates. The system creates
three pre-defined formats if none already exist; these may be edited
or deleted as required.

The pre-defined formats are:

    Default     Emulates the operating system's DIR command (under OS/2
                the DIR format presented for HPFS/longname drives is
                used rather than the FAT format).

    Brief       This format favours display of file description.

    Full        Displays as much information as possible, with the
                filename in the centre and file information to the left.

Many combinations are possible, some more useful than others. There
is no explicit limit to the number of formats which may be defined.
Within InspectA, the Alt-F8 key combination toggles from one format
to the next.

Press INS to add a new format to the list, DEL to delete an existing
format, or ENTER (or F2) to edit the currently highlighted entry.

The top entry in the list is special in that it is the default format
used when opening a new window in the File Manager. If you wish to
change the default format to any of the others displayed, highlight
the one to move to the top, hold down either SHIFT key and press
HOME (or press the UP arrow) to move the entry to the top.

┌─────────────────────────────────────────────────────────────────────┐
└─ File List Templates ───────────────────────────────────────────────┘

FileList templates are comprised of the following fields:

 ■ Format Name    This is a descriptive name for the template.
                  It is information only, but will normally indicate
                  the use for which the template is intended.

 ■ Col Scale
 ■ Row Scale      These fields are used when a new File Manaager
                  window is opened (and therefore are only used if
                  the template is the first in the template list).

   These fields determine the size of the newly opened directory
   window. Both are scaled to 256 - imagine that the screen is
   256 columns x 256 rows large; the number of 'columns' and 'rows'
   specified here determines the proportion of the current screen
   size that the new window will use.  For example, if 128x128 is
   given, the window will be approximately half the actual number of
   columns wide by half the actual number of rows in height.

   Note that these fields are used only when OPENING A NEW WINDOW.
   They do not change the size of an existing window.

 ■ Fields         Specifies the field to display. Up to ten 'slots'
                  are available for the 17 (OS/2) or 10 (MSDOS)
                  possible entries.

   Irrespective of the number of fields actually specified, the
   File Manager window display will only show as much as can be
   contained in the window, according to its size.

   Note that the 'Marker' field should always be included early
   in the field list, and should always be specified. This ensures
   that marked files can be seen easily on the display, and could
   cause some confusion if the mark is not obvious. For most uses,
   the file name would usually be important too...

┌─────────────────────────────────────────────────────────────────────┐
└─ Description Lists ─────────────────────────────────────────────────┘

This window displays a list of files used, in order of preference, for
containing file descriptions.

When a new directory is entered, InspectA searches for any one of these
files, in the order as seen on this window, until it finds that one
exists. When found, it proceeds to open that file and match any
descriptions it contains with the list of files in the directory.

Note that InspectA only uses one of these files at a time - it will
never read or maintain multiple files. If one of the named files is 
found in a directory, then this file is used for all description 
maintenance. If none is found, and a new description is added, InspectA
uses the first filename as the name of the new description file it creates.

Press INS to add a new filename to the list, DEL to delete an entry,
or ENTER/F2 to edit the name of the currently highlighted entry.

To reorder the list, hold down the SHIFT key and use the cursor keys
to move the highlighted entry up or down in the list.

┌─────────────────────────────────────────────────────────────────────┐
└─ Description Lists ─────────────────────────────────────────────────┘

This window presents a form for entry or editing of a description list
file name. Press PGUP for more assistance on the use of these files.

┌────────────────────────────────────────────────────────────────────────────┐
└─ Archiver Templates ───────────────────────────────────────────────────────┘

This form is used to define archive command templates, which determine how
InspectA invokes archiving programs to manipulate compressed file archives.

Entry of the following fields is required:

 ■ Arcv Type      Select the archive type from the list presented. See below
                  (PgDn) for a list of supported archive formats.

 ■ Operation      Select the operation the current command is to carry out.

   If an archive format supports directories, you need to define both
   Extract(Recursive) and Add(Recursive) commands which extract and add
   with paths respectively in order to be able to repack from and to this 
   format. If the type does not support directories, then you still need to
   define Extract(Recursive) in order to repack an archive to a type which
   does.

 ■ Extension      This is the usual file extension (without the dot) that
                  archives of this type use.

 ■ Command        This is the command template itself.

   The template will usually consist of the the name of the program to run,
   any command line switches necessary for the operation, and one or more
   macros, which are substituted at runtime for the archive name, selected
   file names or archive member names.

   A macro is the symbol '$' followed by one or more optional modifiers,
   followed by a keyletter.
                                                          Available Macros
   ╒═════╤════════════════════════════════════════════════════════════════╕
   │Macro│ Description                                                    │
   ╞═════╪════════════════════════════════════════════════════════════════╡
   │ $a  │ Name of archive                                                │
   │ $p  │ Directory in which the target archive resides                  │
   │ $f  │ Individual file or archive member name                         │
   │ $m  │ Multiple file or archive member names, space separated         │
   │ $r  │ 'Response file', containing multiple file/archive member names │
   │ $$  │ Literal '$' character                                          │
   ╘═════╧════════════════════════════════════════════════════════════════╛

   NOTES:

     ■  The $f macro will cause the command to be run multiple times, once
        for each file in a list (if only one file is given to the operation,
        then the command will only be run once).

     ■  The $f macro can be used multiple times on the same command line - 
        it will always be replaced by the same filename in any one command.

     ■  The $m command may cause a command line to be executed more than
        once if the substitution of all the supplied file/member names would
        cause the maximum command line length to be exceeded (this applies
        more to MSDOS, which has a severe limitation of 126 characters per
        command).

     ■  The response file created by the $r macro is a text file, with
        one file/member name per line. This is created in one of the 
        directories selected in the following order:

            ∙ TEMP environment variable
            ∙ if not set, TMP environment variable
            ∙ if not set, HOME environment variable
            ∙ root directory of the current drive
            ∙ current directory

        If the response file cannot be created in any one of these places,
        or a write error occurs when writing the response file (for example,
        if the disk is full), the next option is tried. If this list is
        exhausted, then the archiving operation will fail.

     ■  Response files are always created with an 8 character hexadecimal
        name, with the extension "$$$".

   By default, file names substituted into macros are in fully qualified
   form (d:\path\file.ext). Modifiers may be used to change this behaviour.
   A modifier is a character placed between the '$' and the keyletter. More
   than one modifier may be specified in a macro (although sometimes this
   will not make any sense).
        
      ╒═════╤═══════════════════════════════════════════════════════╕
      │Modif│ Description                                           │
      ╞═════╪═══════════════════════════════════════════════════════╡
      │  +  │ Remove path (result is file name only)                │
      │  -  │ Remove extension (including the dot)                  │
      │  =  │ Removes path and extension - equivalent to "+-"       │
      │  _  │ Extract extension only, remove drive/path/basename    │
      │  .  │ Remove trailing dots from filename                    │
      │  #  │ Use 'UNIX' style forward slash as directory separator │
      ╘═════╧═══════════════════════════════════════════════════════╛

   Examples:
            Original                    Result
            --------------------------- -----------------------------
      $a    D:\MY\PATH\MYFILE.ZIP       D:\MY\PATH\MYFILE.ZIP
      $+a   D:\MY\PATH\MYFILE.ZIP       MYFILE.ZIP
      $-a   D:\MY\PATH\MYFILE.ZIP       D:\MY\PATH\MYFILE
      $=a   D:\MY\PATH\MYFILE.ZIP       MYFILE
      $_a   D:\MY\PATH\MYFILE.ZIP       ZIP
      $.a   D:\MY\PATH\MYFILE.          D:\MY\PATH\MYFILE
      $#a   D:\MY\PATH\MYFILE.ZIP       D:/MY/PATH/MYFILE.ZIP

 ■ Wildcard       This field contains the character(s) - if any - to use 
                  when archiving an entire directory or extracting all 
                  member files in an archive. This avoids having to run
                  the archive command multiple times to achieve the same
                  result.

 ■ Memory         [MSDOS version only] This is the amount of memory required
                  by the archiving command.

   This is used for 'smart swapping'. See IConfig General/Swapping for more
   detailed information.


    ╒══════╤══════════════════════════╤═════════╤════════════╕
    │ Type │ Description              │ OS      │ Source     │
    ╞══════╪══════════════════════════╪═════════╪════════════╡
    │ AR5  │ ARC version 5.x          │ DOS/OS2 │ SEA        │
    │ PKA  │ PKARC/PKPAK              │ DOS     │ PKWARE     │
    │ PAK  │ PAK 2.5x                 │ DOS     │ NoGate     │
    │ AR6  │ ARC version 6.x          │ DOS/OS2 │ SEA        │
    │ AR7  │ ARC version 7            │ DOS/OS2 │ SEA        │
    │ ZIP  │ PKZIP 1.10               │ DOS/OS2 │ PKWARE     │
    │ ZI2  │ PKZIP 2.x                │ DOS     │ PKWARE     │
    │      │ Info-Zip 1.9+            │ DOS/OS2 │ InfoZip    │
    │ LZH  │ LHARC 1.x                │ DOS     │ Yoshi      │
    │      │ LH 1.x+                  │ OS2     │ A:WARE     │
    │ LHA  │ LHA 2.x                  │ DOS     │ Yoshi      │
    │      │ LH 2.x+                  │ OS2     │ A:WARE     │
    │ ZOO  │ ZOO 2.0                  │ DOS/OS2 │ Dhesi      │
    │ ZOH  │ ZOO 2.1+ high compression│ DOS/OS2 │ Dhesi      │
    │ ARJ  │ ARJ                      │ DOS     │ Jung       │
    │      │ UNARJ                    │ DOS/OS2 │ Jung       │
    │ HPK  │ HPACK 0.78+              │ DOS/OS2 │ Gutmann    │
    │ SQZ  │ SQZ 1.08.3               │ DOS     │ Hammarberg │
    │ DWC  │ DWC 5.01A                │ DOS     │ Cooper     │
    ╘══════╧══════════════════════════╧═════════╧════════════╛
┌────────────────────────────────────────────────────────────────────────────┐
└─ Mailer Type ──────────────────────────────────────────────────────────────┘

This screen determines how your FidoNet mailer stores outbound mail.

 ■ Outbound       Outbound mail storage is usually in one of two 
                  types:

     √ Static     Outbound mail files, packets and 'attach lists' are
                  stored in a directory tree, with the names of the
                  directories themselves used to determine the
                  destination address of a bundle, mail packet or
                  attach/request list.

                  Mailers in this class include BinkleyTerm, Opus and
                  PoP.

     √ Dynamic    This type of mailer uses a netmail directory in *.MSG
                  format which contains individual messages and file
                  attaches. The mailer program itself is responsible
                  for the bundling of mail.

                  Dynamic mailers include FrontDoor, InterMail and SEAdog.

 ■ Zones          Enables zone support on outbound mail. 
 ■ Points         Enables point support on outbound mail.
 ■ Domain         Enables domain support on outbound mail.

   These three fields are used for Static mail systems only, and should be
   set to No for any dynamic mailer. Zones enables zone-based directories,
   Points enables point (*.PNT) subdirectories, and Domain enables domain
   based outbound directories.

 ■ Pointnet       Set this to the value used for your 'pointnet', if any.
                  This is used for 3D -> 4D address translation. You do not
                  need to set the Points field to use this.

┌─────────────────────────────────────────────────────────────────────┐
└─ Addresses ─────────────────────────────────────────────────────────┘

This is a list of FTN addresses that your mail system uses to identify
itself. These are in the format:

        [zone:]net/node[.point][@domain]

The first address in this list is called the primary address, and is
used for decoding of addresses and determination of the default zone
number.

Add a new address by pressing INS, remove an existing address by
pressing DEL and edit an address by pressing ENTER or F2.

The order in which addresses are listed may be changed by holding down
the SHIFT key and moving the highlighted entry with the cursor keys.

┌─────────────────────────────────────────────────────────────────────┐
└─ Domain Equivalence ────────────────────────────────────────────────┘

This is a list of domain strings, and is used to equate one string
with another. It is used to map a 'short name' to a 'long name' as
a workaround to MSDOS and FAT filesystem naming limitations, and
because domain names in FSC-0045 packet headers are similarly 
limited to 8 characters.

This translation is automatically used whenever a domain string is
evaluated from an address. It is also used when:

 ■ Mapping a static outbound directory name (limited to 8 characters
   or less on an FAT filesystem) to a full domain name,

 ■ When interpreting an FSC-0045 packet header in which the domain
   string is also limited to 8 characters.

Press INS to add a new entry to this table, DEL to remove an
entry, and ENTER or F2 to edit an existing entry.

┌─────────────────────────────────────────────────────────────────────┐
└─ FTSC Products List ────────────────────────────────────────────────┘

This list maps between product code identifiers in packet headers and
product names. It also sets packet type override flags for specific
products, so that additional addressing information can be safely 
interpreted by in a packet made by specific products which do no 
support any of the packet header formats in either FSC-0045 or 
FSC-0039.

Use INS to add a product record, DEL to delete, ENTER or F2 to
edit. While this list may be manually maintained, typically it is 
entered and updated from the FTSC published product list, known as
FTSCPROD. This published list may be imported into IConfig using 
the F3 key; use the prompt provided to supply the filename, and the
products list is updated directly.

Information stored for each product:

 ■ ID             This is the product identification code, and must
                  be unique for each product. This is a hexadecimal
                  number.

 ■ Name           Short name of the product.

 ■ O/S            Operating system under which the product runs.

 ■ Type           The type of product (all listed products create
                  FidoNet packets; these products are almost always
                  either a "Mailer", "Packer" or both).

 ■ Author         Name of the person responsible for the product.

 ■ Address        FidoNet address of the person responsible for the
                  product.

 ■ Flags          These fields enable InspectA to interpret addressing
                  information contained in packet headers. "3D" means
                  that valid zones can be assumed. "4D" means that
                  valid zone and point addresses can be assumed.

┌─────────────────────────────────────────────────────────────────────┐
└─ Paths Entry ───────────────────────────────────────────────────────┘

This form provides for entry of directory details for the paths list.

 ■ Type           Mosts directories entered into this section will
                  be set to type "Dir". Other available types are
                  used only with the FidoNet Mailer options, and 
                  the directories specified here indicate the
                  following special attributes:

     √ Netmail    Required for Dynamic mailers; only one directory
                  should be defined with this attribute.

     √ Postmail   The directory used when generating a file attach
                  message (if none is defined, the Netmail area is
                  used instead).

     √ Inbound    Sets the named directory as being used by the mailer
                  for receipt of files.

     √ Outbound   Sets the named directory as being used by the mailer
                  to hold outbound mail files. When a Static mailer
                  is in use, only the primary outbound directory
                  should be defined - InspectA will automatically
                  use other related outbound directories (zone, point
                  and domain).

     √ Nodelist   Sets the nodelist attribute - a directory with this
                  attribute contains nodelist index files (use of this
                  attribute is not currently implemented).

 ■ Path           Specifies the directory/path itself.

 ■ Title          This is a descriptive title for the directory. If
                  one is given, this is displayed with the path itself
                  in the File Manager window in which the directory is
                  logged.

┌────────────────────────────────────────────────────────────────────────────┐
└─ Key Definitions ──────────────────────────────────────────────────────────┘


This form allows definition of key bindings in the File Manager, and requires
entry of the following information:

 ■ Key            This field contains the key code you wish to define. If 
                  you are defining a new key you will be asked to simply
                  press the key. If editing or modifying, you will need to
                  press F2 to change the key itself, or just press ENTER
                  to move to the next field and leave it unchanged.

   It is not an error to define more than one function to the same key - 
   however, only the first definition for a key will be executed when that
   key is pressed in the File Manager. This is specifically allowed to 
   make it possible to define many more commands than keys available and
   making these accessible via selection from the pulldown Special menu.

 ■ Operation      Enter the type of action to execute when this key is 
                  pressed.

   While most of InspectA's internal commands may also be reassigned 
   according to preference, the most common selection in this field will be
   Run external command, which provide the facility to map external programs
   and applications to the keyboard.

 ■ Command        This field will be skipped unless the Run external command
                  option is selected in the previous field.

   This field contains a command template, very similar to those used for 
   running archiving software. The template approach allows you to use 
   information from the current file list directly in the command line of 
   any program run.

   Typically, a command template will consist of a command name, zero or more
   command switches, and macros which are substituted at run-time with one or
   more filenames from the current File Manager list.

   A macro is the symbol '$' followed by one or more optional modifiers,
   followed by a keyletter.
                                                          Available Macros
   ╒═════╤════════════════════════════════════════════════════════════════╕
   │Macro│ Description                                                    │
   ╞═════╪════════════════════════════════════════════════════════════════╡
   │ $a  │ Name of the currently highlighted file                         │
   │ $p  │ Current directory name                                         │
   │ $f  │ Individual marked file *                                       │
   │ $m  │ Multiple marked files, space separated *                       │
   │ $r  │ 'Response file', containing all marked files *                 │
   │ $$  │ Literal '$' character                                          │
   ╘═════╧════════════════════════════════════════════════════════════════╛

   * If no files are marked, the filename currently highlighted is used.

   NOTES:

     ■  The $f macro will cause the command to be run multiple times, once
        for each file in a list (if only one file is given to the operation,
        then the command will only be run once).

     ■  The $f macro can be used multiple times on the same command line - 
        it will always be replaced by the same filename in any one command.

     ■  The $m command may cause a command line to be executed more than
        once if the substitution of all the supplied file/member names would
        cause the maximum command line length to be exceeded (this applies
        more to MSDOS, which has a severe limitation of 126 characters per
        command).

     ■  The response file created by the $r macro is a text file, with
        one file/member name per line. This is created in one of the 
        directories selected in the following order:

            ∙ TEMP environment variable
            ∙ if not set, TMP environment variable
            ∙ if not set, HOME environment variable
            ∙ root directory of the current drive
            ∙ current directory

        If the response file cannot be created in any one of these places,
        or a write error occurs when writing the response file (for example,
        if the disk is full), the next option is tried. If this list is
        exhausted, then the command will fail and will not be executed.

     ■  Response files are always created with an 8 character hexadecimal
        name, with the extension "$$$".

   As with the archiver templates, modifiers may be used to change how              
   these macros are substituted:

      ╒═════╤═══════════════════════════════════════════════════════╕
      │Modif│ Description                                           │
      ╞═════╪═══════════════════════════════════════════════════════╡
      │  +  │ Remove path (result is file name only)                │
      │  -  │ Remove extension (including the dot)                  │
      │  =  │ Removes path and extension - equivalent to "+-"       │
      │  _  │ Extract extension only, remove drive/path/basename    │
      │  .  │ Remove trailing dots from filename                    │
      │  #  │ Use 'UNIX' style forward slash as directory separator │
      ╘═════╧═══════════════════════════════════════════════════════╛


 ■ Description    This field should contain a description for external
                  commands. This description is displayed in the Special
                  pulldown menu accessible from the File Manager.

   Note that if no description is allocated, the command will not be
   accessible from the Special menu, only by pressing the key.

 ■ Req mem        [MS-DOS only] This field should be set to the amount of
                  memory that the program needs to run. This enables 'smart'
                  program image swapping. A value of 0 forces InspectA to
                  always swap itself out of memory before running the program
                  and a value of -1 always prevents it.

   Note that you need to enable swapping globally in IConfig/General/Swapping
   before swapping will occur at all.

 ■ Rescan         If enabled (set to Yes), this option causes the current
                  directory to be reread after the command is run. If a
                  command is likely to change the contents of the current
                  directory in any way, then you should enable this so that
                  the display is kept up-to-date.
┌────────────────────────────────────────────────────────────────────────────┐
└─ File Associations ────────────────────────────────────────────────────────┘


This form allows definition of file assocations used by the File Manager.
The purpose of a File Association is to associate an external program with
a file, so that it modifies InspectA's default behaviour (view) when ENTER
is pressed to select the currently highlighted file.

The form provided has the following fields:

 ■ Filespec       This is the file specification to match. Note that more
                    than the file extension is used here - any part of the
                    filename may form part of the pattern.

 ■ Command        This field specifies the command template.

   Typically, a command template will consist of a command name, zero or more
   command switches, and macros which are substituted at run-time with one or
   more filenames from the current File Manager list.

   A macro is the symbol '$' followed by one or more optional modifiers,
   followed by a keyletter.
                                                          Available Macros
   ╒═════╤════════════════════════════════════════════════════════════════╕
   │Macro│ Description                                                    │
   ╞═════╪════════════════════════════════════════════════════════════════╡
   │ $a  │ Name of the currently highlighted file                         │
   │ $p  │ Current directory name                                         │
   │ $f  │ Individual marked file *                                       │
   │ $m  │ Multiple marked files, space separated *                       │
   │ $r  │ 'Response file', containing all marked files *                 │
   │ $$  │ Literal '$' character                                          │
   ╘═════╧════════════════════════════════════════════════════════════════╛

   * If no files are marked, the filename currently highlighted is used.

   NOTES:

     ■  The $f macro will cause the command to be run multiple times, once
        for each file in a list (if only one file is given to the operation,
        then the command will only be run once).

     ■  The $f macro can be used multiple times on the same command line - 
        it will always be replaced by the same filename in any one command.

     ■  The $m command may cause a command line to be executed more than
        once if the substitution of all the supplied file/member names would
        cause the maximum command line length to be exceeded (this applies
        more to MSDOS, which has a severe limitation of 126 characters per
        command).

     ■  The response file created by the $r macro is a text file, with
        one file/member name per line. This is created in one of the 
        directories selected in the following order:

            ∙ TEMP environment variable
            ∙ if not set, TMP environment variable
            ∙ if not set, HOME environment variable
            ∙ root directory of the current drive
            ∙ current directory

        If the response file cannot be created in any one of these places,
        or a write error occurs when writing the response file (for example,
        if the disk is full), the next option is tried. If this list is
        exhausted, then the command will fail and will not be executed.

     ■  Response files are always created with an 8 character hexadecimal
        name, with the extension "$$$".

   As with the archiver templates, modifiers may be used to change how              
   these macros are substituted:

      ╒═════╤═══════════════════════════════════════════════════════╕
      │Modif│ Description                                           │
      ╞═════╪═══════════════════════════════════════════════════════╡
      │  +  │ Remove path (result is file name only)                │
      │  -  │ Remove extension (including the dot)                  │
      │  =  │ Removes path and extension - equivalent to "+-"       │
      │  _  │ Extract extension only, remove drive/path/basename    │
      │  .  │ Remove trailing dots from filename                    │
      │  #  │ Use 'UNIX' style forward slash as directory separator │
      ╘═════╧═══════════════════════════════════════════════════════╛


 ■ Description    This field should contain a description of the 
                    association.

 ■ Req mem        [MS-DOS only] This field should be set to the amount of
                  memory that the program needs to run. This enables 'smart'
                  program image swapping. A value of 0 forces InspectA to
                  always swap itself out of memory before running the program
                  and a value of -1 always prevents it.

   Note that you need to enable swapping globally in IConfig/General/Swapping
   before swapping will occur at all.

 ■ Rescan         If enabled (set to Yes), this option causes the current
                  directory to be reread after the command is run. If a
                  command is likely to change the contents of the current
                  directory in any way, then you should enable this so that
                  the display is kept up-to-date.

